Using kzb files

Kzb files contain contents of your Kanzi Studio projects. To run your Kanzi application on a device, you need to export it as a kzb file.

When user starts a Kanzi application, Kanzi loads the content of one or more kzb files. Kanzi loads the content to RAM and GPU memory when it needs to render it. See Resource management.

You can configure your Kanzi application:

In the C++ application in the onConfigure() function.
In application.cfg by setting the parameters for Kanzi Studio projects with or without C++ application.

See Application configuration reference.

To run a Kanzi application on Windows, you need to have Visual C++ Redistributable x86 for Visual Studio 2015 installed. See Deploying Kanzi applications to Windows.

Creating a kzb file from a Kanzi Studio project

To create a kzb file from a Kanzi Studio project, open your Kanzi Studio project and select File > Export > Export KZB.

Kanzi Studio creates in the <ProjectName>/Application/bin directory these files:

<project_name>.kzb contains the content of your project in binary format.
<project_name>.kzb.cfg contains a list of kzb files. If your Kanzi application includes application code, Kanzi by default configures the C++ application to load the binaries listed in this file
```
configuration.binaryName = "<project_name>.kzb.cfg"
```
(Optional) <project_name>.kzb.txt contains a list of paths to project items in the exported kzb file. You can use these paths to access the content of your Kanzi application in the application code.
To set whether you want to export this file, select Edit > User Preferences and in the Advanced tab set the Create table of contents of kzb file option.
(Optional) <project_name>.kza contains your project in XML format.
To create this file, before you export the kzb file select Edit > User Preferences and in the Advanced tab enable the Create XML version (kza) of kzb file option.

TIP

Kanzi Studio by default names the kzb file <project_name>.kzb. You can set the name of the kzb file in the Project > Properties using the Binary File Name property.

TIP

When you want to permanently remove all kzb files exported from a project select File > Export > Delete Exported Binaries.
Kanzi Studio deletes all exported files from the directory set in the Project > Properties in the Binary Export Directory property. This command deletes all exported files, including those from other projects.

Opening a kzb file

Kanzi comes with the kzb Player you can use to open kzb files on Windows. For example, open kzb files with the kzb Player to visually inspect the content in kzb files. You can find the kzb Player in the <KanziInstallation>/Studio/Bin directory.

To run a Kanzi application on Windows, you need to have Visual C++ Redistributable x86 for Visual Studio 2015 installed. See Deploying Kanzi applications to Windows.

To open a kzb file:

In Kanzi Studio main menu select File > Export > Export KZB.
Kanzi Studio exports the kzb file from your project.

Open the command line in the <KanziInstallation>/Studio/Bin directory and run

kzb_player_GL_vs2015_Release_DLL.exe "C:\KanziWorkspace_3_6_3_2514\Projects\MyProject\Binary\myproject.kzb"

Setting how Kanzi loads a kzb file

The presence of the Screen node in a kzb file determines how Kanzi loads a kzb file.

To set whether Kanzi Studio exports the Screen node to the kzb file of that project, in the Project > Properties set the Export Project Settings to KZA/KZB property to: